Skip to content

Add Noonlight integration#45718

Open
brentb2529 wants to merge 1 commit into
home-assistant:nextfrom
brentb2529:noonlight-docs
Open

Add Noonlight integration#45718
brentb2529 wants to merge 1 commit into
home-assistant:nextfrom
brentb2529:noonlight-docs

Conversation

@brentb2529
Copy link
Copy Markdown

@brentb2529 brentb2529 commented Jun 2, 2026

Proposed change

Documentation for the new noonlight integration, which connects Home Assistant to Noonlight's emergency-services dispatch API so automations can request a real police, fire, or medical response. The page covers setup (sandbox/production environments and the production safety acknowledgment), the entities and actions, the dispatch lifecycle, options, the reachability heartbeat, multi-property setups, and example automations.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Copilot AI review requested due to automatic review settings June 2, 2026 22:17
@home-assistant home-assistant Bot added current This PR goes into the current branch has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch labels Jun 2, 2026
@home-assistant
Copy link
Copy Markdown

home-assistant Bot commented Jun 2, 2026

It seems that this PR is targeted against an incorrect branch since it has a parent PR on one of our codebases. Documentation that needs to be updated for an upcoming release should target the next branch. Please change the target branch of this PR to next and rebase if needed.

@netlify
Copy link
Copy Markdown

netlify Bot commented Jun 2, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit ad1a023
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6a2058e285e1d5000956503d
😎 Deploy Preview https://deploy-preview-45718--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a new documentation page for the Noonlight integration, explaining setup, entities, actions, options, and usage examples for emergency dispatch automations.

Changes:

  • Introduces integration docs with prerequisites and config flow steps, including sandbox vs production safety guidance
  • Documents entities, action schema, dispatch lifecycle, options, and troubleshooting guidance
  • Provides YAML automation examples for dispatch and cancellation flows

Comment on lines +48 to +52
| Entity | Type | Description |
| ------ | ---- | ----------- |
| `binary_sensor.noonlight_<site>_dispatch_pending` | Binary sensor | `on` during the cancelable entry-delay grace window. Use it to drive a CANCEL button in your dashboard. |
| `binary_sensor.noonlight_<site>_dispatch_active` | Binary sensor (safety) | `on` while a dispatch is live with Noonlight (responders requested). |
| `binary_sensor.noonlight_<site>_api_reachable` | Binary sensor (connectivity, diagnostic) | `on` while the [heartbeat](#heartbeat) confirms Noonlight is reachable and your token is valid. |
Comment on lines +144 to +154
automation:
- alias: "Intrusion - Noonlight police"
triggers:
- trigger: state
entity_id: binary_sensor.front_door_glass_break
to: "on"
actions:
- action: noonlight.dispatch_police
data:
entry_delay_seconds: 30
instructions: "Triggered by {{ trigger.to_state.name }}"
Comment on lines +117 to +119
{% note %}
Caller, address, and site-label changes are **not** made in the options — they change what is sent to responders, so they are handled by the [Reconfigure](#reconfigure) action instead.
{% endnote %}
@brentb2529 brentb2529 changed the base branch from current to next June 2, 2026 22:23
@home-assistant home-assistant Bot removed needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch current This PR goes into the current branch labels Jun 2, 2026
@home-assistant home-assistant Bot added the next This PR goes into the next branch label Jun 2, 2026
@c0ffeeca7 c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Jun 3, 2026
@c0ffeeca7 c0ffeeca7 removed request for a team, allenporter, mib1185 and starkillerOG June 3, 2026 06:34
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for contributing, 👍

As this PR is related to a code PR, please rebase and point this PR against the next branch.

If you do not want to rebase, try the following.

  1. Close this PR.
  2. Switch to the next branch and pull the latest next branch.
  3. Create a new branch based on that.
  4. Please restore the original PR template (see PULL_REQUEST_TEMPLATE.md)

@home-assistant home-assistant Bot marked this pull request as draft June 3, 2026 06:36
@home-assistant
Copy link
Copy Markdown

home-assistant Bot commented Jun 3, 2026

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

@brentb2529
Copy link
Copy Markdown
Author

Rebased onto the latest next. The branch had been cut from an outdated base and was carrying 30+ unrelated commits/files; it now contains a single commit with only source/_integrations/noonlight.markdown. Marking ready for review.

@brentb2529 brentb2529 marked this pull request as ready for review June 3, 2026 12:39
@home-assistant home-assistant Bot requested a review from c0ffeeca7 June 3, 2026 12:39
Copy link
Copy Markdown
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please restore the original PR template (see PULL_REQUEST_TEMPLATE.md)

@home-assistant home-assistant Bot marked this pull request as draft June 3, 2026 13:02
@brentb2529
Copy link
Copy Markdown
Author

Restored the original PR template and filled it in (type of change, parent PR links, and checklist). Thanks for the review!

@brentb2529 brentb2529 marked this pull request as ready for review June 3, 2026 13:14
@home-assistant home-assistant Bot requested a review from c0ffeeca7 June 3, 2026 13:14
Comment thread source/_integrations/noonlight.markdown
Comment thread source/_integrations/noonlight.markdown Outdated
Comment thread source/_integrations/noonlight.markdown Outdated
Comment thread source/_integrations/noonlight.markdown Outdated
@home-assistant home-assistant Bot marked this pull request as draft June 3, 2026 13:34
@brentb2529
Copy link
Copy Markdown
Author

Thanks for the detailed review @c0ffeeca7! Addressed all three points:

  • Changed the {% caution %} block to {% important %} (per the ANSI Z535.6 guidance — thanks for the explanation).
  • Moved the setup fields into a {% configuration_basic %} block.
  • Split the "Actions" section into one ### Action heading per action with a data-attributes table (matching the style used by e.g. the Telegram bot integration). For context: the actions (dispatch_police/dispatch_fire/dispatch_medical, dispatch_all, cancel, test_dispatch) are part of the companion core PR Add Noonlight integration core#172875, so they're documented in this PR. Happy to adjust the format if you'd prefer something different.

@brentb2529 brentb2529 marked this pull request as ready for review June 3, 2026 13:50
@home-assistant home-assistant Bot requested a review from c0ffeeca7 June 3, 2026 13:50
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on new-integration This PR adds documentation for a new Home Assistant integration next This PR goes into the next branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants